package top.lixunda.ecommerce.server.good.api.controller;

import com.baomidou.mybatisplus.core.metadata.IPage;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import top.lixunda.commerce.common.core.entity.MessageObject;
import top.lixunda.common.validate.XumValid;
import top.lixunda.ecommerce.server.business.api.entity.vo.ImageUploadTokenVO;
import top.lixunda.ecommerce.server.business.api.entity.dto.PageDTO;
import top.lixunda.ecommerce.server.business.api.entity.QiNiuCallbackBody;
import top.lixunda.ecommerce.server.good.api.entity.db.FileCollectionDO;
import top.lixunda.ecommerce.server.good.api.entity.dto.FileCollectionQueryDTO;
import top.lixunda.ecommerce.server.good.api.entity.vo.FileCollectionVO;

import javax.servlet.http.HttpServletRequest;
import java.util.List;

/**
 * 用于保存图片或文件，保存的图片或文件可以多次使用
 *
 * @author lixunda
 * @version time:2020/3/31 11:43
 */
@SuppressWarnings("unused")
@Api("文件集合操作接口")
@RequestMapping("/file-collection")
public interface IFileCollectionController {

    /**
     * 获取当前用户保存的文件
     *
     * @return 文件数据列表
     */
    @ApiOperation("获取当前用户保存的文件")
    @GetMapping("queryCollectionsByUser")
    MessageObject<List<FileCollectionDO>> queryCollectionsByUser();

    /**
     * 根据name获取当前用户保存的文件
     *
     * @param name name
     * @return 文件数据列表
     */
    @ApiOperation("根据name获取当前用户保存的文件")
    @GetMapping("queryCollectionsByUserWithName")
    MessageObject<List<FileCollectionDO>> queryCollectionsByUserWithName(
            @RequestParam("name") String name);

    /**
     * 根据条件分页查询当前用户保存数据
     *
     * @param wrapper 分页查询参数
     * @return 分页数据
     */
    @ApiOperation("根据条件分页查询当前用户保存数据")
    @PostMapping("queryCollectionByUserWrapper")
    MessageObject<IPage<FileCollectionDO>> queryCollectionByUserWrapper(
            @RequestBody @XumValid PageDTO<FileCollectionDO, FileCollectionQueryDTO> wrapper);

    /**
     * 根据id移除数据，权限判断
     *
     * @param ids 编号列表
     * @return 是否移除成功
     */
    @ApiOperation("根据id移除数据，权限判断")
    @PostMapping("removeByIds")
    MessageObject<Boolean> removeByIds(@RequestBody List<Integer> ids);

    /**
     * 获取一个上传图片的token
     *
     * @return ImageUploadTokenVO
     */
    @ApiOperation("获取一个上传图片的token")
    @GetMapping("createUploadToken")
    MessageObject<ImageUploadTokenVO> createUploadToken();

    /**
     * 上传图片回调
     *
     * @param qiNiuCallbackBody 上传文件信息
     * @return 回调数据
     */
    @ApiOperation("上传图片回调")
    @PostMapping("uploadFileCallback")
    MessageObject<FileCollectionVO> uploadFileCallback(
            @RequestBody QiNiuCallbackBody qiNiuCallbackBody);

    /**
     * 根据id下载文件
     *
     * @param id      id
     * @param request HttpServletRequest
     * @return ResponseEntity
     */
    @ApiOperation("根据id下载文件")
    @GetMapping("downloadAsFileById")
    ResponseEntity<byte[]> downloadAsFileById(@RequestParam("id") Integer id, HttpServletRequest request);

}
